home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / wildcat / wcs04.zip / WCSEARCH.DOC < prev    next >
Text File  |  1996-05-09  |  8KB  |  220 lines
  1.         **************************************************************
  2.         *                                                            *
  3.         *          Wildcat BBS User Database Search & Print          *
  4.         *                                                            *
  5.         *                     WCSEARCH.EXE  v0.4                     *
  6.         *                                                            *
  7.         *                     Copyright (c) 1996                     *
  8.         *                                                            *
  9.         *                Sagerquist Micro Engineering                *
  10.         *                                                            *
  11.         *                   1414 W. Kerrick Street                   *
  12.         *                Lancaster, CA 93534-2225 USA                *
  13.         *                  Data BBS: (805) 723-6908                  *
  14.         *                        zs@qnet.com                         *
  15.         *                http://www.av.qnet.com/~zs/                 *
  16.         *                                                            *
  17.         **************************************************************
  18.  
  19.  
  20. DESCRIPTION
  21. -----------
  22.     WCSEARCH will search your Wildcat BBS user database and list the
  23.     users to an ACSII text file and optionally, to your printer.  Up to
  24.     20 fields within the user database record may be chosen to be 
  25.     listed.  Record field names may or may not be placed with the 
  26.     record.  Envelopes may also be printed.
  27.  
  28. OVERVIEW
  29. --------
  30.     WCSEARCH was written by a request of a Wildcat BBS sysop and
  31.     personal friend of mine.  A utility was needed to display the 
  32.     records of his user's database.  Besides the requirement to choose 
  33.     the different fields of the records to display, printing envelopes
  34.     through this program would save hours of work even after the list
  35.     was produced.  WCSEARCH.EXE is the result.
  36.  
  37. SYNTAX
  38. ------
  39.     There is no special syntax, just type WCSEARCH ┘ at the DOS prompt.
  40.  
  41. FILES IN THIS ZIP PACKAGE
  42. -------------------------
  43.     WCSEARCH EXE    <-----    Executable program.
  44.     WCSEARCH DOC    <-----    Document for WCSEARCH.EXE - this file.
  45.     REGISTER FRM    <-----    Fill-Out form for registration.
  46.     FILE_ID  DIZ    <-----    Description for a BBS file list.
  47.  
  48. OTHER FILES
  49. -----------
  50.     WCSEARCH DAT    <-----    Created by WCSEARCH.EXE if it does not 
  51.                 already exist.  Configuration data.
  52.     CAPTURED DAT    <-----    Output binary file from search function.
  53.     CAPTURED TXT    <-----    Output ASCII text file, contains user list.
  54.  
  55. OPERATION
  56. ---------
  57.     WCSEARCH opens to a menu of nine choices:
  58.  
  59.     Perform Search
  60.     --------------
  61.     The user database is searched, and the output file CAPTURED.DAT
  62.     is created.  CAPTURED.DAT is the screened user database records
  63.     from Wildcat's ALLUSERS.DAT.  Later, data is extracted from this
  64.     file for printing to the text file CAPTURED.TXT and the printer.
  65.  
  66.     Name Disqualify
  67.     ---------------
  68.     Up to 10 names may be placed here.  These names, if found (partial
  69.     or complete) when compared to the user's name, disqualifies the 
  70.     record and the record is not included in CAPTURED.DAT.  For example,
  71.     if the name "JOHN" is listed, since the names "JOHN SMITH" and 
  72.     "VICTOR JOHNSTON" both contain "JOHN", both names are disqualified
  73.     and are not included in the list.
  74.  
  75.     ZIP Codes Qualify
  76.     -----------------
  77.     This function allows you to:
  78.         - disqualify area codes from the list.
  79.         - include only specific area codes in the list.
  80.         - disallow any ZIP code screening.
  81.  
  82.     The TAB key allows for choosing the function you desire.
  83.     
  84.     The "Disabled" function disables all ZIP code screening.    
  85.  
  86.     The "Include Only" function will screen IN the records only if
  87.     the user's ZIP code matches one of the ZIP codes listed here.
  88.  
  89.     The "Exclude Only" function will screen OUT the records if the
  90.     user's ZIP code matches one of the ZIP codes listed here.
  91.  
  92.     Numbers placed in either window are saved.  The active function's 
  93.     numbers are shown in yellow.  The inactive function's numbers are
  94.     shown in grey.  This will save you a step when creating different
  95.     lists.
  96.  
  97.     Print Field Select
  98.     ------------------
  99.     Twenty fields of the user database are printable.  Each one is
  100.     listed.  Move the curser to the desired field, and toggle the 'Y'
  101.     or 'N' with the space bar.  When printed, only the fields with
  102.     the 'Y' (Yes) are placed into the output file/printer.
  103.  
  104.     Print
  105.     -----
  106.     The format of output is chosen here.  Include or exclude field
  107.     names.  Print to the text file CAPTURED.TXT only, or print to both
  108.     CAPTURED.TXT and the printer.  Print envelopes.  Choose to exclude
  109.     incomplete envelopes (incomplete records where a necessary part of 
  110.     the address is missing).  Edit the return address for envelopes.  
  111.  
  112.     Move the curser to the desired field, and toggle the 'Y' or 'N' 
  113.     with the space bar.  
  114.  
  115.     When choosing envelopes, the print fields are automatically
  116.     changed to include only the information required for an envelope.
  117.     Print fields are not permanently changed with this feature.
  118.  
  119.     Configuration
  120.     -------------
  121.     Define the directory location of Wildcat BBS's main directory,
  122.     and the directory of the database file ALLUSERS.DAT.  These are
  123.     directories only.  DO NOT include file names.
  124.  
  125.     Also, TAB to the printer port definition, use the SPACE BAR to
  126.     cycle through the three values for printer port addresses.
  127.  
  128.     About S M E
  129.     -----------
  130.     This is just a small blurb about Sagerquist Micro Engineering
  131.     and how to get in touch with me.
  132.  
  133.     Registration
  134.     ------------
  135.     Place your name and registration number in the proper places here.
  136.     Until registration, only 50 names are placed into the output file
  137.     CAPTURED.DAT and subsequently printed.
  138.  
  139.     Exit to DOS
  140.     -----------
  141.     This function, and also the Escape key, will return you to the 
  142.     operating system.
  143.  
  144. REGISTRATION AND SUPPORT
  145. ------------------------
  146.     This is a user supported product.  WCSEARCH.EXE represents many hours
  147.     of work.  This software is Shareware, not free or public domain.
  148.     You are granted a 30 day limited license to evaluate this program,
  149.     after which you must either register the product, or discontinue its
  150.     use.  If you choose to register this program, please make out a check
  151.     or money order for $9.95 payable to:
  152.  
  153.     Sagerquist Micro Engineering
  154.     1414 West Kerrick Street
  155.     Lancaster, CA 93534-2225 USA
  156.  
  157.     California residents add 8.25% Sales Tax of $.82, total: $10.77.
  158.  
  159.     Your registration number will be mailed on receipt of your payment.
  160.  
  161.     Payment is a one time investment which allows you all further revisions
  162.     at no extra expense.
  163.  
  164.     Until registration, only 50 users are listed in the output file
  165.     CAPTURED.DAT.
  166.  
  167.     Please distribute this program, i.e. upload it to other BBSs in your 
  168.     community for others to evaluate and use.  Your comments on this 
  169.     program are gladly accepted (requested, actually) at the addresses
  170.     below.  
  171.  
  172.     The Sagerquist Micro Engineering Support BBS
  173.     Carl Sagerquist - Programmer/Sysop
  174.     300-28800 BAUD 24 Hours
  175.     (805) 723-6908
  176.  
  177.     Internet
  178.     zs@qnet.com
  179.     http://www.av.qnet.com/~zs/
  180.  
  181.     Thank you for supporting WCSEARCH!
  182.  
  183. ERRORLEVELS
  184. -----------
  185.     On exit, WCSEARCH.EXE will return different errorlevels:
  186.  
  187.     ERRORLEVEL  0 No error.
  188.  
  189.     ERRORLEVEL 10 Monitor error: wrong resolution.
  190.  
  191.     ERRORLEVEL 40 Memory allocation error.
  192.  
  193.     ERRORLEVEL 50 File open error.
  194.  
  195.     ERRORLEVEL 60 File read error.
  196.  
  197.     ERRORLEVEL 70 File write error.
  198.  
  199. CREDITS
  200. -------
  201.     Many thanks to Ralph Johnson - Compuca$h BBS (818) 772-7036, 
  202.     Northridge, CA - for requesting, directing and testing this program.
  203.  
  204.     Wildcat BBS is a copyrighted product from Mustang Software, Inc. -
  205.     BBS (805) 873-2400, Bakersfield, CA USA.
  206.  
  207. DISCLAIMER
  208. ----------
  209.     This program is distributed as is.  No warranty, either expressed or
  210.     implied is offered and the programmer is not responsible for any
  211.     damages or expenses that may occur through the use of this program.
  212.     The user shall determine its suitability.  Please communicate any 
  213.     difficulties with the programmer through the BBS at (805) 723-6908
  214.     or the internet at zs@qnet.com.
  215.  
  216. History
  217. -------
  218.     Version 1.0 05/14/96
  219.         - Initial release.
  220.